ACS TPO Policy Configuration Mode Commands


ACS TPO Policy Configuration Mode Commands
 
 
The ACS TPO Policy Configuration Mode is used to configure TPO policies.
 
note_smallImportant: The commands or keywords/variables that are available are dependent on platform type, product version, and installed license(s).
 
ad-filter
This command configures the bypass string for the Advertisement Filter feature.
Product
TPO
Privilege
Security Administrator, Administrator
Syntax
ad-filter ad-click-identity bypass_string
no ad-filter ad-click-identity
no
Removes the bypass string if previously configured.
bypass_string
Specifies the bypass string.
bypass_string must be an alphabetic string of 1 through 14 characters in length.
note_smallImportant: The bypass string must comprise of any of the following characters: “abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ”. Numeric and special characters are not accepted.
Usage
Use this command to configure the bypass string for the Advertisement Blocking with On-click feature. To enable retrieving a blocked advertisement requested by the subscriber, in the HTTP request the bypass string is added to the advertisement’s URL, which TPO interprets and forwards to the Web Server allowing the advertisement to be retrieved.
Example
The following command configures the bypass string as allow:
ad-filter ad-click-identity allow
 
end
Exits the current configuration mode and returns to the Exec mode.
Product
All
Privilege
Security Administrator, Administrator
Syntax
end
Usage
Use this command to return to the Exec mode.
 
exit
Exits the current mode and returns to the parent configuration mode.
Product
All
Privilege
Security Administrator, Administrator
Syntax
exit
Usage
Use this command to return to the parent configuration mode.
 
match-ad
This command specifies the rules used to block advertisements.
Product
TPO
Privilege
Security Administrator, Administrator
Syntax
match-ad priority rule_priority tpo-ruledef tpo_ruledef_name
no match-ad priority rule_priority
no
Removes the specified match advertisement rule configuration.
priority rule_priority
Specifies priority of the match advertisement rule in the TPO policy.
rule_priority must be an integer from1 through 65535, and must be unique in the current TPO policy.
tpo-ruledef tpo_ruledef_name
Specifies name of the TPO rule.
tpo_ruledef_name must be an alpha and/or numeric string of 1 through 63 characters in length.
Usage
Use this command to specify the rules to block advertisements.
Example
The following command creates a match advertisement rule configuration to use the TPO ruledef named tporule1 with priority 1:
match-ad priority 1 tpo-ruledef tporule1
 
match-rule no-ruledef-match
This command specifies the action to be taken when the traffic does not match any TPO ruledef.
Product
TPO
Privilege
Security Administrator, Administrator
Syntax
match-rule no-ruledef-match tpo { none | profile tpo_profile_name }
default match-rule no-ruledef-match
default
Configures the default setting.
Default: none. No TPO profile is selected.
none
Specifies that no TPO profile be used.
profile tpo_profile_name
Specifies the TPO profile to use when there is no rule match.
tpo_profile_name must be the name of a TPO profile, and must be an alpha and/or numeric string of 1 through 63 characters in length.
Usage
Use this command to specify the action to be taken when the traffic does not match any TPO ruledef in the TPO policy.
Example
The following command specifies to use a TPO profile named tpo_profile2 when the traffic does not match any TPO ruledefs in the TPO policy:
match-rule no-ruledef-match tpo profile tpo_profile2
 
match-rule priority
This command specifies the TPO profile to use when the traffic matches a particular TPO ruledef/TPO group-of-ruledefs.
Product
TPO
Privilege
Security Administrator, Administrator
Syntax
match-rule priority rule_priority { tpo-group-of-ruledefs tpo_group_of_ruledefs_name | tpo-ruledef tpo_ruledef_name } tpo { none | profile tpo_profile_name } [ description description ]
no match-rule priority rule_priority
no
Removes the specified match rule configuration.
priority rule_priority
Specifies priority of the rule within the TPO policy.
rule_priority must be an integer from1 through 65535, and must be unique in the current TPO policy.
tpo-group-of-ruledefs tpo_group_of_ruledefs_name
note_smallImportant: The tpo-group-of-ruledefs option is available only in 12.2 and later releases.
Specifies name of the TPO group-of-ruledefs.
If any of the ruledefs within a group-of-ruledefs match, the group-of-ruledefs is considered a match.
tpo_group_of_ruledefs_name must be an alpha and/or numeric string of 1 through 63 characters in length.
tpo-ruledef tpo_ruledef_name
Specifies name of the TPO rule.
tpo_ruledef_name must be an alpha and/or numeric string of 1 through 63 characters in length.
tpo { none | profile tpo_profile_name }
Specifies TPO profile to be used.
none: Specifies that no TPO profile be used.
profile tpo_profile_name: Specifies the TPO profile to be used.
tpo_profile_name must be the name of a TPO profile, and must be an alpha and/or numeric string of 1 through 63 characters in length.
description description
Enables to add a description to this rule priority configuration.
description must be an alpha and/or numeric string of 1 through 127 characters in length.
Usage
note_smallImportant: A maximum of 2048 optimization rules can be configured in the system.
Use this command to specify the TPO profile to use when the traffic matches a particular TPO ruledef/TPO group-of-ruledefs in the TPO policy.
This CLI command can be entered multiple times to specify multiple rules and TPO profiles. The rules are examined in order of priority, until a match is found and the corresponding TPO profile is applied. Lower numbered priorities are examined first.
Example
The following command creates a rule match configuration to use the TPO profile named tpoprofile1 when the traffic matches the TPO ruledef named tporule1 with priority 1:
match-rule priority 1 tpo-ruledef tporule1 tpo profile tpoprofile1
 
 

Cisco Systems Inc.
Tel: 408-526-4000
Fax: 408-527-0883